? ?5 ?6 ?Ω ?√ ?Ï ?‹ @ @ @6 @< @˝ @Ô @Ú @Û A# A$ Ax A¢ A£ A¨ AÍ AÓ Aé B B B Bu Bv B˘ B´ B≤ C Cl C’ CÔ D" Ds DÂ E Ed E” Eû F F= F] F« FØ G# G] Gg G∞ G G≤ Gí H H2 HH Hw HŸ Hπ HÒ I I IF I\ I— I¡ I‹ Iæ J J J? Ju JÊ K1 Kz K• K∑ K√ KÓ L Li L L≠ L∞ L® L¯ L› M) M* M+ Mu M⁄ M∂ M¢ M£ Mï M› NO NQ Nk N≥ N˛ Nú O O O OY O¢ O€ OÁ OÌ P P< PV Pi P| P} P˙ P’ PÎ Q
Q. Qv QŒ Q¬ Q” Q´ Qµ QÓ Q› Qò R4 RM R“ S S SP Sc Sv S≈ S‚ S¿ T T
T T2 Tƒ TÕ TÛ Tù U UX U| U“ Uµ U¶ Uæ Uç V! V4 VH Vy V‘ V¡ V¢ V› W W` W¢ W¨ WÚ WÛ Wó W‡ X0 XG Xz XŒ XÄ Y% Yh Y¯ YÆ Yù Z Z. Za Zu Z≈ Z∏ [$ [l [~ [ [È [ü \ \/ \R \z \‘ \£ ] ]\ ]s ] ]· ]Ó ^( ^. ^o ^x ^˘ ^â ^û _# _D _R _\ _b _u _v _w _Ω _≈ _ı _ƒ _º _Ë _fi _ï ` ` `C `D `r `• `„ `‰ `£ `° `± " `” " `“ `» " `π a " a " a " a aM a≈ a b bs bt - bu - bv " b∑ bÙ bÚ c c cˆ c˜ d d 3 d di d È K 4 à 6 à 6 à 6 à 8 9 4 à ; •à = à ; L @ M
This Technote, originally Technote PR 09 - Print Dialogs: Adding Items, discusses how to add items to the Printing ManagerÕs dialogs.
When the Printing Manager was initially designed, great care was taken to make the interface to the printer drivers as generic as possible in order to allow applications to print without being device-specific. There are times, however, when this type of non-specific interface interferes with the flexibility of an application. An application may require additional information before printing which is not part of the general Printing Manager interface. This Note describes a metho Ad that an application can use to add its own items to the existing style and job dialogs.
This revised Technote reflects the current Macintosh Printing Manager and uses C code instead of the original Pascal.
You can download a complete version of the code in this Technote, PDlog Expand Ä sample code, by clicking on the icon in the Downloadables section at the very end of this Note.
Printing Manager Compatibility Guidelines for the Future
To begin with, you need to be aware of some guidelines that will increase your chances of being compatible with future revisions of Macintosh Printing Manager:
¥ Only add items to the dialogs as described in this technical note. Any other method will decrease your chances of compatibility in the future.
¥ Do not change the position of any item in the current dialogs. This means ?donÕt delete items from the existing item list or add items in the middle. Add items only at the end of the list.
¥ DonÕt count on an item retaining its current position in the list. If you depend on the Draft button being a particular number in the ImageWriterÕs style dialog item list, and we change the Draft buttonÕs item number for some reason, your program may no longer function correctly.
¥ DonÕt use more than half the screen height for your items. Apple reserves the right to expand the items in the standard print dialogs to fill the top half of the screen. Even though LaserWriter 8.4 changes the print dialogs, in order to be compatible with older drivers, you still need to maintain this half-screen rule.
¥ Under LaserWriter 8.4.x the print dialogs have been completely redesigned. If you add items to the print d Xialog 'legally', your items are added to a pane that has the name of your application. If you donÕt add them as recommended in this Note, there will be problems. Please see develop 27 - Print Hints: The All-New LaserWriter Driver Version 8.4 for more details.
¥ Applications should not assume that the print dialogÕs foreground color is black or that the background color is white when they erase their controls. Furthermore, applications should not change the foreground or background colors because other items in the dialog rely on these colors. If an application changes them, the print dialog may end up with strange colors.
The Heart of the Print Dialogs: The TPrDlg Record
Before discussing how the dialogs work, it is important to know that at the heart of the print dialogs is a little-known data structure partially documented in Printi ˇng.h. ItÕs a record called TPrDlg and it looks like this:
struct TPrDlg {
DialogRecord Dlg; /*The Dialog window*/
ModalFilterUPP pFltrProc; /*The Filter Proc.*/
PItemUPP pItemProc; /*The Item evaluating proc.*/
THPrint hPrintUsr; /*The user's print record.*/
Boolean fDoIt;
Boolean fDone;
long lUser1; /* Four longs reserved by Apple for global data */
/* to hang global data.*/
long lUser2; /* More stuff needed by the */
/*printing dialog.*/
long lUser3;
long lUser4;
};
typedef struct TPrDlg TPrDlg;
typedef TPrDlg *TPPrDlg;
typedef TPrDlg *TPPrDlgRef;
All of the information pertaining to a print dialog is kept in the TPrDlg record. This record will be referred to frequently in the discussion below.
How the Dialogs Work
When your application calls PrStlDialog and PrJobDialog, the printer driver calls a routine called PrDlgMain. This function is declared as l follows:
PrDlgMain first calls the pDlgInit routine to set up the appropriate dialog (in Dlg), dialog hook (pItemProc) and dialog event filter (pFilterProc) in the TPrDlg record (shown above). For the job dialog, the address of PrJobInit is passed to PrDlgMain. For the style dialog, the address of PrStlInit is passed. These routines are declared as follows:
After the initialization routine sets up the TPrDlg record, PrDlgMain calls ShowWindow (the window is initially invisible), then it calls ModalDialog, using the dialog event filter pointed to by the pFltrProc field. When an item is hit, the routine pointed to by the pItemProc field is called and the items are handled appropriately. V When the OK button is hit (this includes pressing Return or Enter) the print record is validated. The print record is not validated if the Cancel button is hit.
Adding Your Own Items
To modify the print dialogs, you need to change the TPrDlg record before the dialog is drawn on the screen. You can add your own items to the item list, replace the addresses of the standard dialog hook and event filter with the addresses of your own routines and then let the dialog code handle the necessary functions to make the items visible in your print dialog.
The example codeÕs initialization function adds items to the dialog item list, saves the address of the standard dialog hook (in our global variable prPItemProc) and puts the address of our dialog hook into the pItemProc field of the TPrDlg record. Please note that your dialog hook must call the s `tandard dialog hook to handle all of the standard dialogÕs items.
Note: If you wish to have an event filter, use the same method that you would for a dialog hook.
The C Example Program
Here is an example (written in C) that modifies the job dialog.
Note: The same code works for the style dialog if you globally replace ÔJobÕ with ÔStlÕ.
#include <Printing.h>
#include <Dialogs.h>
#include <Gestalt.h>
#include <MixedMode.h>
#include <SegLoad.h>
#include <Resources.h>
#include <ToolUtils.h>
#include <Fonts.h>
#include <Lists.h>
static TPPrDlg PrtJobDialog; /* pointer to job dialog */
/* Declare ÔpascalÕ functions and procedures */
extern short Append_DITL(TPPrDlg, short); /* Our AppendDITL function. */
extern pascal TPPrDlg MyJobDlgInit(THPrint); /* Our extention to PrJobInit. */
ÿÿÿÿ 7 l0 [ ] , ÿÿÿÿ 8 m0 [ ] , ÿÿÿÿ 9 n0 [ \ - ÿÿÿÿ : p0 [ \ - ÿÿÿÿ ; t0 [ _ + ÿÿÿÿ < v0 [ _ , ÿÿÿÿ % = y‹ ÿÿÿÿ ÿÿ > {0 y y . ÿÿÿÿ ? }0 y y ÿÿÿÿ @ ~0 y y ÿÿÿÿ A 0 y } / ÿÿÿÿ B •0 y } ÿÿÿÿ C ™0 y } ÿÿÿÿ D ≠0 y } ! ÿÿÿÿ E ∞0 y } " ÿÿÿÿ F ≥0 y } # ÿÿÿÿ G ∑0 y { 0 $
ÿÿÿÿ H ∫0 y { 0 %
ÿÿÿÿ I Ω0 y ~ & ÿÿÿÿ J √0 y ~ ' ÿÿÿÿ % K ≈‹ ÿÿÿÿ ( ÿÿ L …0 ≈ ≈ 1 ) ÿÿÿÿ M —0 ≈ ≈ * ÿÿÿÿ N ‘0 ≈ ≈ + ÿÿÿÿ O Ÿ0 ≈ — , ÿÿÿÿ P ⁄0 ≈ — - ÿÿÿÿ Q ∂0 ≈ — . ÿÿÿÿ R Δ0 ≈ — / ÿÿÿÿ S Œ0 ≈ — 0 ÿÿÿÿ T ‚0 ≈ — 1 ÿÿÿÿ U „0 ≈ … 2 6
∏ O ÿÿ ;ÿÿÿÿ ≤ S ÿÿ < <ÿÿÿÿ ¿ W ÿÿ C <ÿÿÿÿ À ^ ÿÿ ? <ÿÿÿÿ Á a ÿÿ <ÿÿÿÿ Â e ÿÿ < ;ÿÿÿÿ Ã h ÿÿ E ÿÿÿÿ Ä o ÿÿ F ÿÿÿÿ Å q ÿÿ ? ;ÿÿÿÿ
Æ r ÿÿ H <ÿÿÿÿ Ç s ÿÿ <ÿÿÿÿ È u ÿÿ &ÿÿ É w u I ÿÿÿÿ Ê z ÿÿ " J <ÿÿÿÿ Ë | ÿÿ " F <ÿÿÿÿ Ì É ÿÿ K <ÿÿ É Í Ê u I ÿÿÿÿ Î Ì ÿÿ L <ÿÿÿÿ Ï Í u ÿÿÿÿ ‹ Î ÿÿ & M >ÿÿÿÿ Ñ Ï ÿÿ & >ÿÿÿÿ Ò ‹ ÿÿ & < >ÿÿ Í Ó Ñ u & I ÿÿÿÿ Ô Ò ÿÿ * < ?ÿÿÿÿ Õ Ó ÿÿ * C ?ÿÿÿÿ Ö Ô ÿÿ N <ÿÿÿÿ ◊ Õ ÿÿ " E <ÿÿÿÿ Ø Ö ÿÿ * N ?ÿÿÿÿ Ù Ø ÿÿ " O <ÿÿÿÿ Ú Ù ÿÿ P <ÿÿ œ Û Ú ÿÿ ÿÿÿÿ Ü Û ÿÿ " <ÿÿÿÿ † Ü ÿÿ " Q <ÿÿÿÿ fi † ÿÿ - @ÿÿÿÿ ß fi ÿÿ 8ÿÿÿÿ à ß ÿÿ 3 Q 8ÿÿÿÿ á à ÿÿ 3 8ÿÿ Óÿÿ HASH‘
RULRÁô› Æÿÿ ÿ ÿÿ # ÿ ÿÿ ‡ @ ÿÿ \ ÿÿ $ ÿÿ ÿ @ ÿÿ $ ÿÿ $ ÿÿ ÿ C ÿÿ ÿÿ ÿ Â B ÿÿ $ ÿÿ H ÿÿ ÿ C ÿÿ l ÿÿ Δ ÿÿ ÿ b B ÿÿ ´ ÿÿ Ø ÿÿ ÿ Â B d ÿÿ ÿ @ C ÿÿ ü ÿÿ i÷ Â B ÿÿ ÿÿ D ÿÿ ÿ ÿÿ h ÿÿ i÷ b B ÿÿ
‘ ÿÿ ° ÿÿ ÿÿ $ ÿÿ H ÿÿ l ÿÿ Δ ÿÿ ´ ÿÿ jÿ À C ÿÿ Ø ÿÿ ü ÿÿ ÿÿ D ÿÿ h ÿÿ ÿ C ÿÿ ÿÿ $ ÿÿ H ÿÿ l ÿÿ ÷ C ÿÿ Δ ÿÿ ´ ÿÿ xÿ C ÿÿ hÿ C ÿÿ îÿ À ÿî C $ .°•.‰° ‚ I ºß› ™¥â䜉°¥”\¥”l¥Ì√¥Ì˛¥µì¥Ì˘ ÿÿ h÷ B ÿÿ ÷ C ÿÿ iÿ  B d ÿÿ ÿ C ÿÿ ÿ C ÿÿ ÿ @ C ÿÿ ÿ À C ÿÿ ÿ C ÿÿ ÿ B ÿÿ ÿ C ÿÿ ÿ C ÿÿ ÿ À ÿî C $ .°•.‰° ‚ I ºß› ™¥â䜉°¥”\¥”l¥Ì√¥Ì˛¥µì¥Ì˘ ˆ Aÿÿ HASHÀE ;À¯ $ ÿ ÿ Cÿ < Cÿ 8 D = E ? E > K÷ / Kÿ * [ÿ 9 œ ¬ù 5 – 3 ∏ 2
ù o
ù ÿ +K÷ 6Kÿ dÿ
, ,0 Q -v .˝ 0À 10 , Q v ˝ À å
/ T y ı Ã , Q v !˝ "À #å %
& / ' T ( y )
0 @ ÿ @‡ @Cÿ :@Kÿ XŸqÄ @Y{qÄ 4e eo 7 . á - LKUP ¢ Œ ‚
¬ ‰ – ˝ ® ‘ Ÿ ¯ ° ± ” “ ´ µ ! " ¶ · # $ ¸ ’ º % » & π ˛ ' ( ) ∏ * + ≤ , - ¿ . ˆ ˜ / 0 1 À 2 ˘ Á 3 4 ˇ Â ı 5 Ã 6 ˙ ˚ 7 8 9 Ä : Å Æ Ç ; È < É Δ = Ê > Ë ? @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~ • ™ ≠ ∞ ≥ ∑ ∫ Ω √ ≈ … Ì Í ⁄ Î Ï ‹ Ñ Ò Ó Ô Õ Ö ◊ Ø ƒ Ù Ú Û Ü † fi ß à á â ã ä å æ ç è é ê ë ì í î ï › ñ ò ó ô õ ö ÷ ø ù ú û ü ‡ fl ÿ
ÿÿ ¡ ‘ 'ÿÿ $ NAME Default
Default SS Header Body Footer Footnote Footnote Index
HeadingH2.H2 Code.CV Heading1.H1 Italic HeadingH3.H3 Bullet Checklist Number Classic > Blue Gray 1 [ Blue Gray 2 yColorful ≈
3D Table 1 ˜
3D Table 2 ¢
Accounting «Harvard ¸Legal ÃDiamond
Bullet+ Title Author )Address U Affiliation Y Bullet items Z Further Ref `Acknowledgments jFooter kFurther Reference Q
guideWorks Titles
Code style uCode 0 D FNTM Helvetica Geneva Times Palatino Courier :H
Letter Gothic ÿÿ
Zapf Dingbats New York ETBL @FNTM ˆ)CUTS ˆ1DSUM ˆ9HDNI ˆrSTYL ˆ|ETBL ìôÿfl‡üûúùø›ñòóôõö÷
